package com.mapper;

import com.bean.Book;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;

@Mapper
public interface BookMapper {
    /**
     * 根据书籍 ID 查询书籍信息，包含关联的分类信息
     * @param id 书籍的唯一标识
     * @return 包含分类信息的书籍对象，如果未找到则返回 null
     */
    Book getBookById(Integer id);

    /**
     * 根据关键字进行分页模糊查询书籍信息，关键字可匹配书名、作者
     * @param keyword 用于模糊查询的关键字
     * @param offset 分页查询的偏移量，即从第几条记录开始查询
     * @param limit 每页显示的记录数量
     * @return 符合条件的书籍列表
     */
    List<Book> getBooksByKeyword(String keyword, int offset, int limit);

    /**
     * 统计根据关键字模糊查询时符合条件的书籍数量
     * @param keyword 用于模糊查询的关键字
     * @return 符合条件的书籍数量
     */
    int countBooksByKeyword(String keyword);

    /**
     * 根据类别 ID 进行分页查询书籍信息
     * @param categoryId 书籍所属类别的唯一标识
     * @param offset 分页查询的偏移量，即从第几条记录开始查询
     * @param limit 每页显示的记录数量
     * @return 该类别下的书籍列表
     */
    List<Book> getBooksByCategoryId(Integer categoryId, int offset, int limit);

    /**
     * 统计某一类别下的书籍数量
     * @param categoryId 书籍所属类别的唯一标识
     * @return 该类别下的书籍数量
     */
    int countBooksByCategoryId(Integer categoryId);

    /**
     * 插入一本新的书籍信息到数据库
     * @param book 包含书籍详细信息的对象
     * @return 插入操作影响的行数，成功插入则返回 1，失败返回 0
     */
    int insertBook(Book book);

    /**
     * 根据书籍 ID 更新书籍的相关信息
     * @param book 包含要更新的书籍信息的对象，其中 ID 用于定位要更新的记录
     * @return 更新操作影响的行数，成功更新则返回 1，失败返回 0
     */
    int updateBook(Book book);

    /**
     * 根据书籍 ID 从数据库中删除对应的书籍信息
     * @param id 要删除的书籍的唯一标识
     * @return 删除操作影响的行数，成功删除则返回 1，失败返回 0
     */
    int deleteBookById(Integer id);
}